package cn.iocoder.yudao.module.lowcode.service.datasource;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.lowcode.controller.admin.datasource.vo.*;
import cn.iocoder.yudao.module.lowcode.dal.dataobject.datasource.DatasourceConfigDO;

import javax.validation.Valid;
import java.util.List;

/**
 * 数据源配置 Service 接口
 *
 * @author YuDao
 */
public interface DatasourceConfigService {

    /**
     * 创建数据源配置
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createDatasourceConfig(@Valid DatasourceConfigSaveReqVO createReqVO);

    /**
     * 更新数据源配置
     *
     * @param updateReqVO 更新信息
     */
    void updateDatasourceConfig(@Valid DatasourceConfigSaveReqVO updateReqVO);

    /**
     * 删除数据源配置
     *
     * @param id 编号
     */
    void deleteDatasourceConfig(Long id);

    /**
     * 获得数据源配置
     *
     * @param id 编号
     * @return 数据源配置
     */
    DatasourceConfigDO getDatasourceConfig(Long id);

    /**
     * 获得数据源配置分页
     *
     * @param pageReqVO 分页查询
     * @return 数据源配置分页
     */
    PageResult<DatasourceConfigDO> getDatasourceConfigPage(DatasourceConfigPageReqVO pageReqVO);

    /**
     * 测试数据源连接
     *
     * @param testReqVO 测试信息
     * @return 测试结果
     */
    DatasourceConnectionTestRespVO testConnection(@Valid DatasourceConfigSaveReqVO testReqVO);

    /**
     * 获取数据源健康状态
     *
     * @param id 数据源编号
     * @return 健康状态
     */
    DatasourceHealthRespVO getHealth(Long id);

    /**
     * 更新数据源状态
     *
     * @param id 编号
     * @param status 状态
     */
    void updateDatasourceStatus(Long id, Integer status);

    /**
     * 获取支持的数据库类型
     *
     * @return 数据库类型列表
     */
    List<String> getSupportedDatabaseTypes();

    /**
     * 根据数据源名称获取数据源配置
     *
     * @param name 数据源名称
     * @return 数据源配置
     */
    DatasourceConfigDO getDatasourceByName(String name);

    /**
     * 获取所有活动状态的数据源配置
     *
     * @return 活动数据源配置列表
     */
    List<DatasourceConfigDO> getActiveDataSourceList();
}